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NAME 

as — assembler 

SYNOPSIS 

as file ... 

DESCRIPTION ' 

As assembles the named files, which must have the suffix ’.s’. The output of the 
assembly is left on the corresponding files with suffix ’.o’. Assembler listings are 
produced on the corresponding files with suffix ’.1st’. 

FILES 

/lib/cpp 
/lib/asm 
/usr/tmp/asm* 

/lib/symfile 
name.s 
name.o 
name .1st 

SEE ALSO 

Ulrike Weng-Beckmann, Assembler 68000 Users Guide 
Motorola, Macro Assembler Reference Manual 

DIAGNOSTICS 

Diagnostics are given in the assembler listing. 


C preprocessor 
assembler 
temporary files 

used for initialization of /lib/asm 
assembler source 
assembled module 
assembler listing 
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NAME 

cc, lcc — C compiler 


SYNOPSIS 

«c [ option ] ... file ... 


DESCRIPTION 

Cc is the UNIX C compiler. It accepts several types of arguments: 

Arguments whose names end with ’.c’ are taken to be C source programs; they 
are compiled, and each object program is left on the file whose name is that of 
the source with ‘.o' substituted for \c'. The '.o' file is normally deleted, however, 
if a single C program is compiled and linked all at one go. This C-compiler has 
the identifier "m68000" predefined, such that "#ifdef m68000" is true. 



A call "cc test.c" is the same as "cc -c test.c && Id /lib/crtO.o test.o -lc && rm 
test.o". The call "cc *.o" is the same as "Id /lib/crtO.o *.o -lc". If your directory 
contains the file xyz.c, a call "make xyz" will result in "cc -o xyz xyz.c". 

The following options are interpreted by cc. See ld{ 1) for link-time options. 

—c Suppress the linking phase of the compilation, and force an object file 

to be produced even if only one program is compiled. 


output 

Name the final output file output. If this option is used the file 'a.out' 
will be left undisturbed. This option is passed on to the linker. 


-f 

-S 


-L 


~g 

~P 


-T 


—u 


This option must be given, if your program includes floating point opera¬ 
tions. The library libffp.a will be searched before libc.a. 

Compile the named C programs, and produce an assembly listing on 
corresponding files suffixed '.s'. This option is used mainly for compiler 
debugging. 

This option, followed by a number, e.g. 1234 (decimal), 01234 (octal) or 
0x1234 (hex), together with option -S starts the program counter in the 
produced assembly-listing with the given number. 

Arrange for the compiler to produce code which puts the current 
linenumber into the stackframe during execution. The C-stacktrace of 
od6(l) (command Sc or SC) will then give you for each active procedure 
the current linenumber. 

Adds entries to the symbol table of the produced .o module which indi¬ 
cate line numbers and corresponding code location. Used by the pbug 
source oriented debugger. 

Arrange for the compiler to produce code which counts the number of 
times each routine is called; also, if linking takes place, replace the 
standard startup routine by one which automatically calls monitor{ 3) at 
the start and arranges to write out a mon.out file at normal termination 
of execution of the object program. An execution profile can then be 
generated by use of pro/(l). 

With this option initialized data is put into the text- rather than the data 
segment. Thus for programs like the shell, whose text segments are 
shared between many users, memory space can be saved. Apply this 
option only to modules with nothing but constant data declarations. 

All characters will be treated as "unsigned char". 



7th Edition 


QU68000 


1 









CC(1) 


UNIX Programmer’s Manual 


CC(1) 


—4 Changes the integer size from 2 (default) to 4. This makes programs 
which neglect the differences between int and pointer or int and long 
much more portable. On the other hand, the produced code is less 
efficient. When the name lcc is linked to cc, lcc is equivalent to cc -4. 
This option is also passed to the linker. 

—2 Like option -4. However, short parameters remain short and char 
parameters are only converted to short, not int, before they are pushed 
on the stack. This option is used for example to compile the system calls 
in the 4-byte-integer standard library /lib/libLc.a, which must interface 
to a 2-byte-integer world. 

—8 Currently, only the Motorola Fast Floating Point Package is available for 

floating point simulation. This package does not implement 64-bit float¬ 
ing point. Therefore, double is considered to be the same as float by 
default. Option -8 changes the default such that sizeof(double) = 8. The 
code generator will then produce calls to procedures dadd, dmul etc. 
for double addition and multiplication, which are not yet implemented. 

—P Run only the macro preprocessor and place the result for each '.c' file in 

a corresponding ‘.i’ file that has no lines in it. 

—E Run only the macro preprocessor and send the result to the standard 

output. The output is intended for compiler debugging; it is unaccept¬ 
able as input to cc. 

—’Dname=def 

—Dname 

Define the name to the preprocessor, as if by ’^define’. If no definition is 
given, the name is defined as 1. 


—Dname 


Remove any initial definition of name. 

—Idir ‘/(include’ files whose names do not begin with ’/’ are always sought first 
in the directory of the file argument, then in directories named in —I 
options, then in directories on a standard list. 

—Bstring 

Find substitute compiler passes in the files named string with the 
suffixes cpp, cO, cl and c2. If string is empty, use a standard backup 
version. 


—t[p012] 


Find only the designated compiler passes in the files whose names are 
constructed by a —B option. In the absence of a —B option, the string is 
taken to be ‘/usr/src/cmd/c/’. 

Other arguments are taken to he either linker option arguments, or C- 
compatible object programs, typically produced by an earlier cc run, or perhaps 
libraries of C-compatible routines. These programs, together with the results of 
any compilations specified, are linked (in the order given) to produce an exe¬ 
cutable program with name a.out. 


FILES 


file c 
file.o 
a.out 


input file 
object file 
linked output 
temporaries for cc 


/tmp/ctm? 
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/lib/cpp 

/lib /c[ 012] 

/usr/c/oc[012] 

/usr/c/ocpp 

/lib/crtO.o 

/lib/mcrtO.o 

/lib/libc.a 

/lib/libffp.a 

/usr/include 


preprocessor 
compiler passes for cc 
backup compiler passes for cc 
backup preprocessor 
runtime initialization 
runtime initialization for profiling 
standard library, see intro{ 3) 
library with floating point routines 
standard directory for '^include' files 


SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Programming Language , Prentice-Hall, 
1978 



D. M. Ritchie, CReference Manual 
monitor(3), prof(l), adb(l), ld(l) 

GNOSTICS 


The diagnostics produced by C itself are intended to be 
Sional messages may be produced by the linker. 


self-explanatory. Occa- 


BUGS 

Option -g should also be usable by adb, so that breakpoints could be set to the 
start of a line. 
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MA1IE 

Id — loader 

SYNOPSIS 

Id [ option ] file ... 

DESCRIPTION 

Ld combines several object programs into one, resolves external references, 
and searches libraries. In the simplest case several object files are given, and 
Id combines them, producing an object module which can be either executed or 
become the input for a further Id run. (In the latter case, the -r option must 
be given to preserve the relocation bits.) The output of Id is left on a.out. This 
file is made executable only if no errors occurred during the load. 

The argument routines are concatenated in the order specified. The entry 
point of the output is the beginning of the first routine. 

If any argument is a library, it is searched exactly once at the point it is 
encountered in the argument list. Only those routines defining an unresolved 
external reference are loaded. If a routine from a library references another 
routine in the library, and the library has not been processed by rardib[l), the 
referenced routine must appear after the referencing routine in the library. 
Thus the order of programs within libraries may be important. If the first 
member of a library is named ‘_.SYMDEF', then it is understood to be a diction¬ 

ary for the library such as produced by ranlib\ the dictionary is searched itera¬ 
tively to satisfy as many references as possible. 

The symbols '_etext', ‘_edata’ and ’_end’ (‘etext’, ‘edata’ and 'end' in C) are 
reserved, and if referred to, are set to the first location above the program, the 
first location above initialized data, and the first location above all data respec¬ 
tively. It is erroneous to define these symbols. 

Ld understands several options. Except for -1, they should appear before the 
file names. 

—s ‘Strip’ the output, that is, remove the symbol table and relocation bits to 

save space (but impair the usefulness of the debugger). This information 
can also be removed by strip (l). 

—u Take the following argument as a symbol and enter it as undefined in the 

symbol table. This is useful for loading wholly from a library, since ini¬ 
tially the symbol table is empty and an unresolved reference is needed to 
force the loading of the first routine. 

—lx This option is an abbreviation for the library name ’/lib/libx.a’, where x 

is a string. If that does not exist, Id tries ’/usr/lib/libx.a'. A library is 
searched when its name is encountered, so the placement of a —1 is 
significant. 

—4 This option changes the library name ’/lib/libx.a’ to ’/lib/libLx.a'. For 
example instead of /lib/libc.a the library /lib/libLc.a is searched. These 
libraries are assumed to include modules which have been produced with 
cc -4. 

—x Do not preserve local (non-.globl) symbols in the output symbol table; 

only enter external symbols. This option saves some space in the output 
file. 

—r Generate relocation bits in the output file so that it can be the subject of 

another Id run. This flag also prevents final definitions from being given 
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to common symbols, and suppresses the 'undefined symbol’ diagnostics. 

—d Force definition of common storage even if the —r flag is present. 

—o The name argument after — o is used as the name of the Id output file, 

instead of a.out. 

—p This argument produces a symbol listing on stdout. 

—y This argument links objects for an unmapped address range, such that 

code, data and bss are contiguous, starting from 0. Useful for Macsbug 
etc. 

—b This option is used to link unix or standalone programs, where code is in 

segment 0 and data and bss in segment 1. If neither —b nor —y are given, 
normal user-mode programs loadable by the kernel are produced, with 
code in segment 6 and data and bss in segment 0. 

—m This option produces "S-records” for Macsbug on file dm.out. 

—e The following argument is taken to be the name of the entry point of the 

loaded program; location 0 is the default. 

—0 This is an overlay file, only the text segment will be replaced by exec(2). 
Shared data must have the same layout as in the program overlaid. 

—D The next argument is a decimal number that sets the size of the data 

segment. 

FILES 

/lib/lib*.a libraries 

/lib/libl,*.a libraries with four-byte integers 

/usr/lib/lib*.a more libraries 

a.out output file 

SEE ALSO 

as(l), ar(l), cc(l), ranlib(l) 

BUGS 

Overlays are not tested. 


7th Edition 


QU68000 


2 










LS(1) 


UNIX Programmer’s Manual 


LS(1) 


NAME 

Is — list contents of directory 


SYNOPSIS 

Is [ —abcdfgilmqrstuxlCFR ] name ... 
1 {Is options ] name ... 


DESCRIPTION „ . 

For each directory argument. Is lists the contents of the directory, for each file argument, is 

repeats its name and any other information requested. The output is sorted alphabetically by 
default. When no argument is given, the current directory is listed. When several arguments 
are given, the arguments are first sorted appropriately, but file arguments appear before direc¬ 
tories and their contents. 


There are three major listing formats. The format chosen depends on whether the output is 
going to a teletype, and may also be controlled by option (lags. The default format for a tele¬ 
type is to list the contents of directories in multi-column format, with the entries sorted down 
the columns. (Files which are not the contents of a directory being interpreted are always 
sorted across the page rather than down the page in columns. This is because the individual Sie 
names may be arbitrarily long.) If the standard output is not a teletype, the default format is to 
list one entry per line. Finally, there is a stream output format in which files are listed across 
the page, separated by V characters. The -m flag enables this format; when invoked as I this 
format is also used. 


There are an unbelievable number of options: 

-1 List in long format, giving mode, number of links, owner, size in bytes, and time of 
last modification for each file. (See below.) If the file is a special file the size field will 
instead contain the major and minor device numbers. 

—t Sort by time modified (latest first) instead of by name, as is normal. 

-a List all entries; usually V and are suppressed. 

—s Give size in blocks, including indirect blocks, for each entry. 

—d If argument is a directory, list only its name, not its contents (mostly used with —1 to 
get status on directory). 

—r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

—u Use time of last access instead of last modification for sorting (—t) or printing (-1). 

—c Use time of file creation for sorting or printing. 

-i Print i-number in first column of the report for each file listed. 

-f Force each argument to be interpreted as a directory and list the name found in each 
slot. This option turns off —1, —t, —s, and —r, and turns on —a; the order is the 
order in which entries appear in the directory. 

—g Give group ID instead of owner ID in long listing. 

—m force stream output format 

—1 force one entry per line output format, e.g. to a teletype 
—C force multi-column output, e.g. to a file or a pipe 

—q force printing of non-graphic characters in file names as the character this normally 
happens only if the output device is a teletype 
—b force printing of non-graphic characters to be in the \ddd notation, in octal. 

-x force columnar printing to be sorted across rather than down the page; this is the 

default if the last character of the name the program is invoked with is an *x\ 
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-F cause directories to be marked with a trailing 7’ and executable files to be marked with 
a trailing this is the default if the last character of the name the program is invoked 
with is a T. 

—R recursively list subdirectories encountered. 

The mode printed under the -1 option contains 11 characters which are interpreted as follows: 
the first character is 

d if the entry is a directory; 
b if the entry is a block-type special file; 
c if the entry is a character-type special file; 
m if the entry is a multiplexor-type character special file; 

— if the entry is a plain file. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers to 
owner permissions; the next to permissions to others in the same user-group; and the last to all 
others. Within each set the three characters indicate permission respectively to read, to write, 
or to execute the file as a program. For a directory, ‘execute’ permission is interpreted to mean 
permission to search the directory for a specified file. The permissions are indicated as follows: 

r if the file is readable; 
w if the file is writable; 
x if the file is executable; 

— if the indicated permission is not granted. 

The group-execute permission character is given as s if the file has set-group-ID mode; likewise 
the user-execute permission character is given as s if the file has set-user-ID mode. 

The last character of the mode (normally ‘x’ or is t if the 1000 bit of the mode is on. See 
chmod{\) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of blocks, including indirect 
blocks is printed. 

FILES 

/etc/passwd to get user ID’s for Ms — F. 

/etc/group to get group ID’S for 'Is — g’. 

BUGS 

Newline and tab are considered printing characters in file names. 

The output device is assumed to be 80 columns wide. 

The option setting based on whether the output is a teletype is undesirable as ‘Ms -s” is much 
different than “Is -s | Ipr”. On the other hand, not doing this setting would make old shell 
scripts which used Is almost certain losers. 

Column widths choices are poor for terminals which can tab. 
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NAME 

newconf - generate configuration file and reconfigure NUNIX 
SYNOPSIS 

/etc/newconf L configuration fiie J 
DESCRIPTION 

Newconf makes a new NUNIX kernel from an already existing or 
from an interactively created configuration file. 

If no configuration file is specified newconf asks for 

- the device drivers to be included 

Ctty driver is automatically included! 

- assignation of DNA extension registers to DNA devices 

- the type and unit of the root and swap device 

- the origin lblock number! and size of the swap area 

- some other system parameters 

Newconf. creates the configuration file / us r/ sys/ co nf.. h as 
include file to the configuration table /usr/sys/'c. c and the 
interrupt vector table /usr/sys/l_.s. 

If a configuration file is specified this file is copied to 
/usr/sys/conf.h. 

Reconfiguration of NUNIX is automatically done by compiling 
/j#sr/sys/c.c , assembling /usr/sy.s/1. s and linking 
/usr/sys/c .g > /u.sr/sys/j . o » the kernel library /usr/sys/jU b_1 
and the driver library /usr/sy.s/J.i.b.2 to a new NUNIX kernel 
named /nunix. 

For later use you should safe the interactively created con¬ 
figuration file /usr/sys/conf.h by renaming it. 

FILES 

/usr/sys/c o nf.h 
/usr/sys/c.* 

/usr/sys/l.* 

/usr/sys/lib1 
/usr/sys/lib2 
/nunix 

SEE ALSU 

whatconf (. 1mJ 

BUGS 


Printed 1U/28/B2 




1 











t 







PACKC3 


UNIX Progrdmmer's Manual 


PACKC 3 


NAME 


pack - packs or unpacks many files <-> one. 

SYNOPSIS 

o3 pack filef [fi1(23 ... CfilenD or 
b3 pock 

DESCRIPTION 

a3 pack filel ... filen 

packs these files onto stdout. Between the files the 
following line is inserted 

</«*«*«#««**«##«<file i>«*»«««#**««**««#*/> 
b3 pack 

unpacks stdin Ca previously packed file! onto the com¬ 
ponent files. 

Hints fgrep '*</' pockedfile 

picks out the names of the component files!. 


EXAMPLEf 


pack ».p I xref 

makes a cross-reference list of a group of files. 
EXAMPLE2 

pack ».c I sed -f change.sed I pock 
seds a whole group of files at once. 


DIAGNOSTICS 

If file cannot be opened the message 


'cannot open file <file>’ is written on stderr. 

If the inputfile has a bad format the message 
* phase error'in line fline numb e r)* is written on stderr. 
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NAME 


vfontinfo - inspect and print out information about unix fonts 


SYNOPSIS 

vfontinfo [ -v ] fontname [ characters J 


Vfontinfo allows you to examine a font in the unix format. It prints out all the information in 
the font header and information about every non-null (width > 0) glyph. This can be used to 
make sure the font is consistent with the format. 


The fontname argument is the name of the font you wish to inspect. It writes to standard out¬ 
put. If it can’t find the file in your working directory, it looks in /usr/lib/rfont (the place most 
of the fonts are kept). 

The characters , if given, specify certain characters to show. If omitted, the entire font is 
shown. 

If the -v (verbose) flag is used, the bits of the glyph itself are shown as an array of X’s and 
spaces, in addition to the header information. 


SEE ALSO 

vpr(l), vfont(5) 

"Die Berkeley Font Catalog 


AUTHORS 

Mark Horton 
Andy Hertzfeld 
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NAME 


vpr, vprm, vpq, vprint - raster primer/plotter spooler 


r width ] [ -m ] [ name ... ] 


SYNOPSIS 

vpr [ -W ] I -1 ] I -v 1 l -t [ -1234 font ] ] [ -w 11 -i 
{id ... 1 l filename ... ] [ owner ... ] 

print [ — W ] file ... 

DESCRIPTION 

Vpr causes the named files to be queued for printing or typeset simulation on one of the avail¬ 
able raster printer/plotters. If no files are named, the standard input is read. By default the 
input is assumed to be line printer-like text. For very wide plotters, the input is run through 
the filter / usr/lib/sidebyside giving it an argument of — w 106 which arranges it four pages adjacent 
with 90 column lines (the rest is for the left margin). Since there are 8 lines per inch in the 
default printer font, vpr thus produces 86 lines per page (the top and bottom lines are left 
blank). 

The following options are available: 

—1 print the input in a more literal, manner. Page breaks are not inserted, and 

most control characters (except format effectors: \n, \f, etc.) are printed (many 
control characters print special graphics not in the ASCII character set.) Tab 
and underline processing is still done. If this option is not given, control char¬ 
acters which are not format effectors are ignored, and page breaks are inserted 
after an appropriate number of lines have been printed on a page. 

—W Queues files for printing on a wide output device, if available. Normally, files 

are queued for printing on a narrow output device. 

—1234 Specifies a font to be mounted on font position i. The daemon will construct a 

.railmag file referencing /usr/lib/vfont/name.size. 

—in Report by mai!{ 1) when printing is complete. 

_ w (Applicable only to wide output devices.) Do not run the input through sideby- 

side. Such processing has been done already, or full (440 character) pnnter 
width is desired. 

-w width Use width width rather than 90 for sidebyside. 

-v Use the filter /usrllib/vrast to convert the vectors to raster. The named files 

must be a parameter and vector file (in that order) created by versaploti 3x) 
routines. 

1, use the filter /usr/!ib/vcat to typeset the input on the printer/plotter. The input 

must have been generated by trojffl 1) run with the — t option. This is not 
normally ran directly to wide output devices, since it is wasteful to run only 
one page across. The program vtrojff\ 1) is normally used and arranges, using 
vsort(l) for printing to occur four pages across, conserving paper. 

Vprm removes entries from the raster device queues. The id, filename or owner should be that 
reported by vpq. All apropriate files will be removed. Both queues are always searched. The id 
of each file removed from the queue will be printed. 

Vpq prints the queues. Each entry in the queue is printed showing the owner of the queue 
entry, an identification number, the size of the entry in characters, and the file which is to be 
printed. The id is useful for removing a specific entry from the printer queue using vprm 
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Vprint is a shell script which pr's a copy of each named file on one of the electrostatic 
printer/plotters. The files are normally printed on a narrow device; —W option causes them to 
be printed on a wide device. 

FILES 

/usr/spool/v?d/* 

/usr/lib/v?d 
/usr/lib/vpd 
/usr/lib/vpf 
/usr/lib/*vcat 
/usr/lib/vrast 
/usr/lib/sidebyside 

SEE ALSO 

troff(l), vfont(5), vp(4), pti(l), vtroff(l), versaplot(3x) 

BUGS 

You can't run bit maps in a queued fashion to the plotters. This is because the volume of the 
data (more than 1 Megabyte per vertical foot) is unwieldy. Instead you must follow the 
instructions in vp(4) and run your program when the plotter is idle, or run it in the background 
and have it wait for the device to become idle. 

Queued jobs print in directory (seemingly random) order. The plotters are fast enough that 
this is not a real problem. 

The l's (one’s) and l’s (lower-case el’s) in a Benson-Varian’s standard character set look very- 
similar, caution is advised. 

Vprm should have options allowing just one of the queues to be searched. 

A versatec’s hardware character set is rather ugly. Vpnnt should use one of the constant width 
fonts to produce prettier listings. 


device spool areas 

daemons 

Versatec daemon 

filter for primer simulation 

filter for typeset simulation 

filter for versaplot 

filler for wide output 
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NAME 

vtroff — troff to a raster plotter 

SYNOPSIS^ ] [ _f majorfont ] [ -123 minorfont ] ( -llength] l -x] troff arguments 
DESCRIPTION 

Vtroff runs avffil) sending its output through various programs to produce typeset output on a 
raster plotter such as a Benson-Varian or or a Versatec. The -W option specifies that a wide 
output device be used; the default is to use a narrow device. The -I (lower case U option 
causes the output to be split onto successive pages every length inches rather than the default 

11 ”. 

The default font is a Hershey font. If some other font is desired you can give a -F argument 
and then the font name. This will place normal, italic and bold versions of the font on posi¬ 
tions 1, 2, and 3. To place a font only on a single position, you can give an argument of the 
form -n and the minor font name. A .r will be added to the minor font name if needed. 
Thus “vtroff —ms paper” will set a paper in the Hershey font, while “vtroff — F nonie —ms 
paper” will set the paper in the (sans serif) nonie font. The -x option asks for exact simula¬ 
tion of photo-typesetter output (I.e. using the width tables for the C.A.T. photo-typesetter) 


FILES 


/usr/lib/ tmac/ tmac. vcat 
/usr/lib/fontinfo/* 

/ usr/lib/vfont 


default font mounts and bug fixes 
fixes for other fonts 
directory containing fonts 


SEE ALSO 

troff(l), nettroff(l), vfont(5), vpr(l) 


Since some macTO packages work correctly only if the fonts named R, I, B, and S are mounted, 
and since the-Versatec fonts have different widths for individual characters than the fonts found 
on the typesetter, the following dodge was necessary: If you don't use the “.fp ’ troff directive 
then you get the widths of the standard typesetter fonts suitable for shipping the output of troff 
over the network to the computer center A machine for phototypesetting. If, however, you 
remount the-R, I, B and S fonts, then you get the width tables for the Versatec. 
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NAME 

whatconf - what device drivers are In an unlx kerne 
SYNOPSIS 

/etc/whatconf unixkernel 
DESCRIPTION 

Whatconf tells you what devices the specified unlx 
configured for. 

SEE ALSO 

newconft1m J 




t 
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NAME tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal independent operation routines 

SYNOPSIS 

char PC; 
char «BC; 
char »UP; 
short ospeed; 

tgetent (bp, name) 
char »bp, •name; 

tgetnum (id) 
char *id; 

tgetflag (id) 
char «id; 

char • 

tgetstr (id, area) 
char *id, »»area; 

char • 

tgoto(cm, destcol, destline) 
char «cm; 

tputs (cp, affcnt, outc) 
register char »cp; 
int affcnt; 
int (•outc)0; 


DESaUPTTON ta c ti on s exm£t md ^ from .he wmittal apability hem tee ml5). 

These are low level routines; see curses(3) for a higher level package. 

Tgetent extracts the entry for terminal name into the buffer at bp. Bp should be * 
buffer of size 1024 and must be retained through all subsequent calls to tgetnum. gefl 

Tgetent returns -l if it cannot open the rermcep file, 0 if the terminal t*medo* 
not have in entry, and 1 if all goes well. It will look in the environment for a TERMCAP van- 
able If found, and the value does not begin with a slash, and die terminal type name is e 
same as the environment string TERM, the TERMCAP string is used instead of read mg the 
termcaD file If it does begin with a slash, the stnng is used as a path name rather than 
/etc/termcap. This can speed up entry into programs that call tgetent » wdl as to» helpi debug 
new terminal descriptions or to make one for your termmal if you can t wnte the file 

/etc/termcap. 

Tgetnum gets the numeric value of capability id. returning -1 if is not f ven J or th * [ er ™^* 
Taotflno paturns 1 if the soecified capability is present in the terminal s entry, 0 if it s 

il placing i. in .he buffer at arm. advancing .be a„c 

pointer.**it decodes 'he abbreviations for this Seld described .n tirmapd), except for cursor 
addressing and padding information. 

Teoto returns a cursor addressing string decoded from cm to go to column destcol in line Asrfjw. 
Ruses the external variables UP (from the up capability) and BC (if be is given rather * s) 
if necessary to avoid placing \n, ‘D or *@ in the returned stnng. (Programswhich^lltgom 
shouldbesure to turn off the XTABS bit(s), since tgoto may now output a tab. Note that p 
grans using termcap should in general turn off XTABS anyway since some termmals use con- 
trolTfofotheTfunctions, such as nondestructive space.) If a % sequence is given which is not 
understood, then tgoto returns “OOPS”. 
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Tputs decodes the leading padding information of the string cp; affcnt gives the number of lines 
affected by the operation, or 1 if this is not applicable, outc is a routine which is called with 
each character in turn. The external variable ospeed should contain the output speed of the ter¬ 
minal as encoded by srty (2). The external variable PC should contain a pad character to be 
used (from the pc capability) if a null (*@) is inappropriate. 

FILES 

/usr/lib/libtermcap.a —1 term cap library 
/etc/termcap data base 

SEE ALSO 

ex(l), curses(3), termcap(5) 

AUTHOR 

William Joy 

BUGS 
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NAME 

xd - hexadecimal dump 


SYNOPSIS 

xd Z file 3 Z offsetIC . 3C b 3 Z 


Coffset2C . 3C b ] ] 


DESCRIPTION 

Xd dumps file in hexadecimal and os characters. 

The file argument specifies which file is to be dumped. If 
no file argument is specified* the standard input is used. 

The offset argument specifies the offset in the file where 
dumping is to commence. This argument is normally inter¬ 
preted os hexadecimal bytes. If it starts with '0'. the 


offset is Interpreted in octal. If * •* is appended* the 
offset is interpreted in decimal. If 'b' is appended* the 
offset is interpreted in blocks of 512 bytes. If the fil* 
argument is omitted* the offset argument must be preceded 


If no second offset is specified, dumping continues until. 
end-of-file. Otherwise dumping ends before the specified 
endaddress. The interpretation of offset2 is the same os 


above• 

SEE ALSO • 
adbC1D 
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hk • RK 61 1/RK06, RK07 moving head disk 

DESCRIPTION , . 

The octal representation of the minor device number is 
. encoded do , where d Is a physical drive numoer, and P is a 
pseudodrive (subsection) within a physical unit. The ori¬ 
gins and sizes ©£ the pseudodisks on eaen drive, counted in 
cylinders of 66 512 -oyte blocks, are; 


pseudodisk 

start cyl. 

1ength 

size (in blocks) 

0 

0 

146 

9636 

1 

146 

135 

8910 

2 

281 

129 

8514 

3 

281 

533 

35178 

4 

0 

0 

0 

5 

0 

0 

0 

6 

0 

410 

27060 

7 

0 

814 

53724 


Systems distributed for these devices use disk 0 for the 
root, disk 1 for swapoing, and disk 2 (PKOb) or disk 3 
(RK07) for a mounted user file system. Oisk 6 (RK06) or 
disk 7 (RK07) may oe used to create a mounted user file sys¬ 
tem, which consists of an entire disk pack. 

The block files access tne disk via the system's normal 
buffering mechanism and may be read and written without 
regard to physical disk records. 

k 'raw' interface provides for direct transmission between 
the disk and the user's read or write buffer. A single read 
or write call results in exactly one I/O operation and 
therefore raw I/O is conslderaely more efficient wnen manv 
words are transmitted. The names of tne raw files conven¬ 
tionally begin with an extra % r. # In raw I/O the buffer must 
begin on a word boundary. 


piles 

/dev/hk?, /dev/rhk? 


In raw I/O read and write (2) truncate file offsets to 512- 
oyte block boundaries, and write scribeles on the tail of 
incomoiete blocks. Thus, in orograms that are likely to 
access raw devices, read, write and lseek (2) should always 
deal in 512-oyte multiples. 
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NAME 


fstab — static information about the filesystems 


SYNOPSIS 

♦include <fstab.h> 

Dtseitprio^ descriptive in/ormaUon about the various Be systems. *rc£mb is 

ZadZTw ams. and -to. written; it is -he duty of the system admmtstrator to property 
create and maintain this file. 

These Droarams use /etc/fstab: dump , mount, umount, swapon , fick and df, The order of records in 

both Afc *»»"<. arid umovnt seduemially iterate duou,h /«c//s»p 

doing their thing. 

The special (Ue turns is the block special Be name, and not the character “ * 

program needs the character special Be name, the program must create it by appending 
after the last “/” in the special file name. 

ff * rvar is “rw” or “ro” then the file system whose name is given in the A/fe field is nor- 
mady ^mounted*read’write or read-only on the specified special Be. The “ “ used f« 

these file systems by the dumpi 8) command to determine which file systems need 
dumoed The fs oassno field is used by the fecki 8) program to determine the order in which 
checi^e done at reboot time. The root file system should be specified with a 
* passno of 1, and other file systems should have larger numbers. File systems within a rive 
slS have distinct numbers, but file systems on different drives can be checked on the sam 
pa ss to utilize parallelism available in the hardware. 

If 6 rw* is “sw” then the special file is made avaiable as a piece of swap space by the 
command at .he end of -he ryr.em reboo. procedure. The fielde other .ban ye.cpec 

and fs type ait not used in this case. 

Fs type may be specified as “xx” to cause an entry to be ignored. This is useful to show disk 
partitions which are currently not used but will be used later. 


#define FSTAB 
#define FSNMLG 


•/etc/fstab* 

16 


#define FSTABFMT -%16s:%16s:%2s:%d:%d\n’ _ 

#define FSTABARG(p) (p)->fs_spec, (p)->fs_file, \ 

(p) — >fs_type, & (p) ~ > fsjreq, 4(p) >fs_passno 

#define FSTABNARGS 5 


#define FSTAB.RW 
#define FSTAB_RO 
#define FSTAB_S'W 
#define FSTAB_XX 


*rw’ 

"ro" 

•sw’ 

*xx’ 


/• read write device •/ 
/• read only device •/ 
/• swap device •/ 

/• ignore totally •/ 


struct fstab ( . 

char fs spectFSNMLGl; /• block special device name •/ 

char fs~file[FSNMLG]; /• file system path prefix •/ 


); 


char fs_typel3]; 
int fsjreq; 
int fs_passno; 


/• rw.ro.sw or xx •/ 

/• dump frequency, in days •/ 

/• p*« number on parallel dump •/ 
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The proper way to read records from /etc/fstab is to use the routines getfsentO, getfsspecO or 
getfsfileO. 

FILES 

/etc/fstab 

SEE ALSO 

getfsentO) 
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NAME 


termcap - terminal capability data base 


SYNOPSIS 

/etc/termcap 

DESCRIPTION a ^ base describing terminals, used, e.g., by w(l) and «/rses(3).Terminals are 

described in termcap by giving a set of capabilities which they have, an y escri i g 
operations are performed. Padding requirements and initialization sequences are included m 

termcap. 

Entries in termcap consist of a number of V separated fields. The first entry for each terrmna 
lives the names which are known for the terminal, separated by f characters. The first name 
always*2 characters long and is used by older version 6 systems which store the terminal type in 
a 16 bit word in a systemwide data base. The second name given is the most common aborevi- 
ation for the terminal, and the last name given should be a long name fully' 
minal. The second name should contain no blanks; the last name may well contain blanks for 

readability. 

CAPABILITIES 

(P) indicates padding may be specified 

(p.) indicates that padding may be based on no. lines affected 




Name 

Type Pad? 

Description 

ae 

str 

(P) 

End alternate character set 

ai 

sir 

(P-) 

Add new blank line 

am 

bool 


Terminal has automatic margins 

as 

str 

(P) 

Start alternate character set 

be 

str 


Backspace if not *H 

bs 

bool 


Terminal can backspace with *H 

bt 

str 

(P) 

Back tab 

bw 

bool 


Backspace wraps from column 0 to last column 

CC 

str 

. 

Command character in prototype if terminal settable 

cd 

str 

(P-) 

Clear to end of display 

ce 

str 

(P) 

Clear to end of line 

ch 

str 

(P) 

Like cm but horizontal motion only, line stays same 

d 

str 

(P-) 

Gear screen 

cm 

str 

(P) 

Cursor motion 

CO 

num 


Number of columns in a line 

cr 

str 

(P*) 

Carriage return, (default *M) 

cs 

str 

(P) 

Change scrolling region (vtlOO), like cm 

cv 

str 

(P) 

Like ch but vertical only. 

da 

bool 


Display may be retained above 

dB 

num 


Number of millisec of bs delay needed 

db 

bool 


Display may be retained below 

dC 

num 


Number of millisec of cr delay needed 

dc 

str 

(P-) 

Delete character 

dF 

num 


Number of millisec of ff delay needed 

dl 

str 

(P-) 

Delete line 

dm 

str 


Delete mode (enter) 

dN 

num 


Number of millisec of nl delay needed 

do 

str 


Down one line 

dT 

num 


Number of millisec of tab delay needed 

ed 

str 


End delete mode 
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ei 

str 

eo 

str 

ff 

str 

he 

bool 

hd 

str 

ho 

str 

hu 

str 

hz 

str 

ic 

str 

if 

str 


im 

bool 


in 

bool 


ip 

str 

(p*) 

is 

str 


k0-k9 

sir 


kb 

str 


kd 

str 


ke 

str 


kh 

str 


ki 

str 


kn 

num 


ko 

str 


kr 

str 


ks 

str 


ku 

str 


10-19 

str 


li 

num 


U 

str 


ma 

str 


mi 

bool 


ml 

str 


mu 

str 


nc 

bool 


nd. 

str 


til 

str 

(p*) 

ns 

bool 


os 

bool 


PC 

str 


P* 

bool 


se 

sir 


sf 

str 

(p) 

sg 

num 


so 

str 


sr 

str 

(p) 

ta 

str 

(p) 

tc 

sir 


te 

str 


ti 

str 


uc 

str 


ue 

str 


ug 

num 


ul 

bool 



End insert mode; give “:ei—if ic 
Can erase overstrikes with a blank 
Hardcopy terminal page eject (default *L) 

Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 

Home cursor (if no cm) 

Half-line up (reverse 1/2 linefeed) 

Hazeltine; can’t print *’s 

Insert character 

Name of file containing is 

Insert mode (enter); give “am-:” if ic 

Insert mode distinguishes nulls on display 

Insert pad after character inserted 

Terminal initialization string 

Sent by “other” function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of “keypad transmit” mode 

Sent by home key 

Sent by terminal left arrow key 

Number of “other” keys 

Termcap entries for other non-function keys 

Sent by terminal right arrow key 

Put terminal in “keypad transmit” mode 

Sent by terminal up arrow key 

Labels on “other” function keys 

Number of lines on screen or page 

Last line, first column (if no cm) 

Arrow key map, used by vi version 2 only 
Safe to move while in insert mode 
Memory lock on above cursor. 

Memory unlock (tum off memory lock). 

No correctly working carriage return (DM2500,H2000) 
Non-destructive space (cursor right) 

Newline character (default \n) 

Terminal is a CRT but doesn’t scroll. 

Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 

End stand out mode 
Scroll forwards 

Number of blank chars left by so or se 
Begin stand out mode 
Scroll reverse (backwards) 

Tab (other than ‘I or with padding) 

Entry of similar terminal - must be last 

String to end programs that use cm 

String to begin programs that use cm 

Underscore one char and move past it 

End underscore mode 

Number of blank chars left by us or ue 

Terminal underlines even though it doesn’t overstrike 
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up str 

us str 

vb str 

ve str 

vs str 

xb bool 

xn boot 

xr bool 

xs bool 

xt bool 


Upline (cursor up) 

Start underscore mode 

Visible bell (may not move cursor) 

Sequence to end open/visual mode 
Sequence to start open/visual mode 
Beehive (fl-escape, f2-ctrl C) 

A newline is ignored after a wrap (Concept) 
Return acts like ce \r \n (Delta Data) 

Standout not erased by writing over it (HP 264?) 
Tabs are destructive, magic so char (Teleray 1061) 


A Sample Entry 

The following entry, which describes the Concept —100, is among the more complex entries in 
the termcap file as of this writing. (This particular concept entry is outdated, and is used as an 
example only.) 

cl I c 1001 concept 100:is—\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo&\200:\ 

:a j— 3 .\E'R:am:bs:cd—16»\E*C:ce— 16\E*S:cl — 2»*L:cm—\Ea%+ %+ :co#80:\ 

:dc—l6\E*A:dl —3*\E*B:ei—\E\200:eo:im—\E*P:in:ip—16»:li#24:mi:nd—\E —:\ 

:se— \Ed\Ee:so— \ED\EE:ta—8\t:ul:up—\E;:vb—\Ek\EK;xn: 

Entries may continue onto multiple lines by giving a \ as the last character of a line, and chat 
empty fields may be included for readability (here between the last field on a line and the firs; 
field on the next). Capabilities in termcap are of three types: Boolean capabilities which indicate 
that the terminal has some particular feature, numeric capabilities giving the size of the termi¬ 
nal or the size of particular delays, and string capabilities, which give a sequence which can be 
used to perform particular terminal operations. 

Types of Capabilities 

All capabilities have two letter codes. For instance, the fact that the Concept has “automatic 
margins” (i.e. an automatic return and linefeed when the end of a line is reached) is indicated 
by the capability am. Hence the description of the Concept includes am. Numeric capabilities 
are followed by the character *#’ and then the value. Thus co which indicates the number ot 
columns the terminal has gives the value ‘80’ for the Concept. 

Finally, string valued capabilities, such as ce (dear to end of line sequence) are given by the 
two character code, an and then a string ending at the next following *:\ A delay in mil¬ 
liseconds may appear after the in such a capability, and padding characters are supplied by 
the editor after the remainder of the string is sent to provide this delay. The delay can be 
either a integer, e.g. ‘20’, or an integer followed by an *•’, i.e. ‘3-’. A *•’ indicates that the 
padding required is proportional to the number of lines affected by the operation, and the 
amount given is the per-afTected-unit padding required. When a *•’ is specified, it is sometimes 
useful to give a delay of the form ‘3.5’ specify a delay per unit to tenths of milliseconds. 

A number of escape sequences are provided in the string valued capabilities tor easy encoding 
of characters there. A \E maps to an ESCAPE character, ‘x maps to a control-x for any 
appropriate x, and the sequences \n \r \t \b \f give a newline, return, tab. backspace and 
formfeed. Finally, characters may be given as three octal digits after a \, and the characters 
and \ may be given as \* and \\. If it is necessary to place a : in a capability it must be escaped 
in octal as \072. If it is necessary to place a null character in a string capability it must be 
encoded as \200. The routines which deal with termcap use C strings, and strip the high bits of 
the output very late so that a \200 comes out as a \000 would. 
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Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective way to prepare a 
terminal description is by imitating the description of a similar terminal in termcap and to build 
up a description gradually, using partial descriptions with ex to check that they are correct. Be 
aware that a very unusual terminal may expose deficiencies in the ability of the termcap file to 
describe it or bugs in ex. To easily test a new terminal description you can set the environment 
variable TERMCAP to a pathname of a file containing the description you are working on and 
the editor will look there rather than in letcJtermcap. TERMCAP can also be set to the termcap 
entry itself to avoid reading the file when starting up the editor. (This only works on version 7 
systems.) 

Basic capabilities 

The number of columns on each line for the terminal is given by the co numeric capability. If 
the terminal is a CRT, then the number of lines on the screen is given by the li capability. If 
the terminal wraps around to the beginning of the next line when it reaches the right margin, 
then it should have the am capability. If the terminal can clear its screen, then this is given by 
the cl string capability. If the terminal can backspace, then it should have the bs capability, 
unless a backspace is accomplished by a character other than *H (ugh) in which case you 
should give this character as the be string capability. If it overstrikes (rather than clearing a 
position when a character is struck over) then it should have the os capability. 

A very important point here is that the local cursor motions encoded in termcap are undefined 
at the left and top edges of a CRT terminal. The editor will never attempt to backspace around 
the left edge, nor will it attempt to go up locally off the top. The editor assumes that feeding 
off the bottom of the screen will cause the screen to scroll up, and the am capability tells 
whether the cursor sticks at the right edge of the screen. If the terminal has switch selectable 
automatic margins, the termcap file usually assumes that this is on, i.e. am. 

These capabilities suffice to describe hardcopy and “glass-tty” terminals. Thus the mode! 33 
teletype is described as 

t3|33|tty33:co#72:os 

while the Lear.Siegier aDM-3 is described as 

d|adm3t3jsi adm3:am:bs:d“*Z;li#24:co#80 
Cursor addressing 

Cursor addressing in the terminal is described by a cm string capability, with printftts ) like 
escapes %x in it. These substitute to encodings of the current line or column position, while 
other characters are passed through unchanged. If the cm string is thought of as being a func¬ 
tion. then its arguments are the line and then the column to which motion is desired, and the 
% encodings have the following meanings: 

%d as in print/, 0 origin 
%2 like %2d 

%3 like %3d 

%. like %c 

%+x adds xto value, then %. 

%>xy if value > x adds y, no output. 

%r reverses order of line and column, no output 
%i increments line/column (for 1 origin) 

%% gives a single % 

%n exclusive or row and column with 0140 (DM2500) 

%B BCD (16»(x/10)) + (x%10), no output. 

%D Reverse coding (x-2»(x%16)), no output. (Delta Data). 
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ss?*: ssriu z "3s? 

^ j w v a *r with the row and column simply encoded m binary, cm T%. . • 

need to to backspace the cursor (bs or be), and to move the cursor up 

2STon L screen l °up^introduced bel’ow). This is — b«» it is not always safe to 
transmit \t, \n *D and \r, as the system may change or discard them. 

A final example is the LSI ADM-3a, which uses row and column offset by a blank character, thus 
“cm-\E-%+ %+ ”• 

Cursor motions , „ t , 

’^~:&.^S£2SS3:ssi 

,f U 5""°"^Si'T’no” maddressability. bul can home the cursor (to vary upper 

S S'colTc'SUTvcn-T turns'? invo^SV^h £fpl‘r'om^£; 

Pm me pdTtm Will neve? do this itself (unless II does) because u makes no assumption about 
the effect of moving up from the home position. 

Area clears 

column of a line. 

Insert/delete line . .. , 

with sb may bring down non-blank lines. 

Insert/deiete character 

^P^SSasSiSSsKSSSS 

i=i3=SiSSSHi 

mntions Tvoe fc4 abc def" using local cursor motions (not spaces) between the a 
"«r Thropostdon ■?, cursor btfnre the “abc" and pu, thetetmina 1 in msen mo<lei f.tyP- 
ing characters causes the rest of the line to shift rigidly and characters to fall o ’ shifts 

your terminal does not distinguish between blanks and untyped positions^ lhe 

. u ,„ |i>« » d +r' which then move together around the end of the current line an 
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may have to modify the editor to get it to use the insert mode your terminal defines. We have 
seen no terminals which have an insert mode not not failing into one of these two classes. 

The editor can handle both terminals which have an insert mode, and terminals which send a 
simple sequence to open a blank position on the current line. Give as im the sequence to get 
into insert mode, or give it an empty value if your terminal uses a sequence to insert a blank 
position. Give as ei the sequence to leave insert mode (give this, with an empty value also if 
you gave im so). Now give as ic any sequence needed to be sent just before sending the char¬ 
acter to be inserted. Most terminals with a true insert mode will not give ic, terminals which 
send a sequence to open a screen position should give it here. (Insert mode is preferable to the 
sequence to open a position on the screen if your terminal has both.) If post insert padding is 
needed, give this as a number of milliseconds in ip (a string option). Any other sequence 
which may need to be sent after an insert of a single character may also be given in ip. 

It is occasionally necessary to move around while in insert mode to delete characters on the 
same line (e.g. if there is a tab after the insertion position). If your terminal allows motion 
while in insert mode you can give the capability mi to speed up inserting in this case. Omitting 
mi will affect only speed. Some terminals (notably Datamedia’s) must not have mi because of 
the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and dc 
to delete a single character while in delete mode. 

Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout mode these can be given as so and se 
respectively. If there are several flavors of standout mode (such as inverse video, blinking, or 
underlining — half bright is not usually an acceptable “standout” mode unless the terminal is 
in inverse video mode constantly) the preferred mode is inverse video by itself. If the code to 
change into or out of standout mode leaves one or even two blank spaces on the screen, as the 
TVI 912 and Teieray 1061 do, this is acceptable, and although it may confuse some programs 
slightly, it can’t be helped. 

Codes to begin underlining and end underlining can be given as us and ue respectively. If the 
terminal has a code to underline the current character and move the cursor one space to the 
right, such as the Microterm Mime, this can be given as uc. (If the underline code does not 
move the cursor to the right, give the code followed by a nondestructive space.) 

If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) 
then this can be given as vb; it must not move the cursor. If the terminal should be placed in a 
different mode during open and visual modes of «r. this can be given as vs and ve, sent at the 
start and end of these modes respectively. These can be used to change, e.g.. from a underline 
to a block cursor and back. 

If the terminal needs to be in a special mode when running a program that addresses the cur¬ 
sor, the codes to enter and exit this mode can be given as ti and te. This arises, for example, 
from terminals like the Concept with more than one page of memory. If the terminal has only 
memory relative cursor addressing and not screen relative cursor addressing, a one screen-sized 
window must be fixed into the terminal for cursor addressing to work properly. 

If your terminal correctly generates underlined characters (with no special codes needed) even 
though it does not overstrike, then you should give the capability ul. If overstrikes are erasable 
with a blank, then this should be indicated by giving eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are pressed, this information 
can be given. Note that it is not possible to handle terminals where the keypad only works in 
local (this applies, for example, to the unshifted HP 2621 keys). If the keypad can be set to 
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transmit or not transmit, give these codes as ks and ke. Otherwise the keypad is assumed to 
always transmit. The codes sent by the left arrow, right arrow, up arrow, down arrow, and 
home keys can be given as kl, kr, ku, kd, and kh respectively. If there are function keys such 

as fO, fl.f9, the codes they send can be given as krt, kl, k9. If these keys have labels 

other than the default fO through f9. the labels can be given as 10, 11.19. If there are other 

keys that transmit the same code as the terminal expects for the corresponding function, such 
as dear screen, the termcap 2 letter codes can be given in the ko capability, for example, 
“:ko-cl.U,sf,sb:’\ which says that the terminal has dear, home down, scroll down, and scroll 
up keys that transmit the same thing as the cl, 11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on terminals which have single character arrow 
keys. It is obsolete but still in use in version 2 of vi, which must be run on some minicomput¬ 
ers due to memory limitations. This field is redundant with kl, kr, ku, kd, and kh. It consists 
of groups of two characters. In each group, the first character is what an arrow key sends, the 
second character is the corresponding vi command. These commands are h for kl, j for kd. k 
for ku. 1 for kr. and H for kh. For example, the mime would be :ma“‘Kj*Zk*Xl: indicating 
arrow keys left CH), down (*K), up (*Z), and right (*X). (There is no home key on the 
mime.) 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then this can be given as pc. 
If tabs on the terminal require padding, or if the terminal uses a character other than *1 to tab. 
then this can be given as ta. 

Hazeltine terminals, which don’t allow **• characters to be printed should indicate hz. 
Datamedia terminals, which echo carriage-return linefeed for carriage return and then ignore a 
following linefeed should indicate nc. Early Concept terminals, which ignore a linefeed 
immediately after an am wrap, should indicate xn. If an erase-eol is required to get rid of stan¬ 
dout (instead of merely writing on top of it), xs should be given. Teleray terminals, where tabs 
turn all characters moved over to blanks, should indicate xt. Other specific terminal problems 
may be corrected by adding more capabilities of the form xx 

Other capabilities include is, an initialization string for the terminal, and if. the name of a file 
containing long initialization strings. These strings are expected to properly dear and then set 
the tabs on the terminal, if the terminal has settable tabs. If both are given, is will be printed 
before if. This is useful where if is /usr/lib/tabset/std but is clears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being just like the other with cer¬ 
tain exceptions. The string capability tc can be given with the name of the similar terminal. 
This capability must be lost and the combined length of the two entries must not exceed 1024 . 
Since termlib routines search the entry from left to right, and since the tc capability is replaced 
by the corresponding entry, the capabilities given at the left override the ones in the similar ter¬ 
minal. A capability can be cancelled with xx@ where xx is the capability. For example, the 
entry 

hn|2621nl:ks@:ke@:tc-2621: 

defines a 2621nl that does not have the ks or ke capabilities, and hence does not turn on the 
function key labels when in visual mode. This is useful for different modes for a terminal, or 
for different user preferences. 

FILES 

/etc/termcap file containing terminal descriptions 
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SEE ALSO 

ex(l), curses(3), termcap(3). tset(l), vi(l), uKl), more(l) 

AUTHOR 

William Joy 

Mark Horton added underlining and keypad support 

BUGS 

Ex allows only 256 characters for string capabilities, and the routines in termcapCJ) do not check 
for overflow of this buffer. The total length of a single entry (excluding only escaped newlines! 
may not exceed 1024. 

The tna, rs, and ve entries are specific to the vi program. 

Not ail programs support all entries. There are entries that are not supported by any program. 
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NAME 

ttytype - data base of terminal types by port 

SYNOPSIS 

/etc/ttytype 

DESCRIPTION . J , . . . . 

Ttytype is a database containing, for each tty port on the system, the kind of terminal tnat is 
attached to it. There is one line per port, containing the terminal kind (as a name listed in 
termcap (5)), a space, and the name of the tty, minus /dev/. 

This information is read by tseti 1) and by login (1) to initialize the TERM variable at login time. 

SEE ALSO 

tset(l), login(l) 

BUGS 

Some lines are merely known as “dialup” or “plugboard”. 
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NAME 

vfont - font formats for the Benson-Varian or Versatec 

SYNOPSIS 

/asr/lib/rfont/* 

DESCRIPTION 

The fonts for the printer/plotters have the following format. Each file contains a header, an 
array of 256 character description structures, and then the bit maps for the characters them¬ 
selves. The header has the following format: 

struct header { 

short magic, 

unsigned short size; 
short maxx; 

short maxy; 

short xtnd; 

} header. 

The magic number is 0436 (octal). The maxx, maxy. and xtnd fields are not used at the current 
time. Maxx and maxy are intended to be the maximum horizontal and vertical size of any 
glyph in the font, in raster lines. The size is the size of the bit maps for the characters in bytes. 
Before the maps for the characters is an array of 256 structures for each of the possible charac¬ 
ters in the font. Each element of the array has the form: 


struct dispatch { 


unsigned short 

addr. 

short 

nbytes; 

char 

up; 

char 

down; 

char 

left; 

char 

right; 

short 

width; 


}; 

The nbytes field is nonzero for characters which actually exist. For such characters, the addr 
field is an offset into the rest of the file where the data for that character begins. There are 
up+down rows of data for each character, each of which has left+right bits, rounded up to a 
number of bytes. The width field is not used by vcat, although it is used by vwidth(l) to make 
width tables for troff. It represents the logical width of the glyph, in raster lines, and shows 
where the base point of the next glyph would be. 

FILES 

/usr/lib/vfont/« 


SEE 


ALSO 


troff(l), pti(l), vpr(l), vtroff(l). vwidth(l), vfontinfo(l), fed(l) 
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NAME 

fish — play “Go Fish” 

SYNOPSIS 

/usr/games/fish 

DESCRIPTION 

Fish plays the game of “Go Fish”, a childrens’ card game. The Object is to accumulate ‘books’ 
of 4 cards with the same face value. The players alternate turns; each turn begins with one 
player selecting a card from his hand, and asking the other player for all cards of that face 
value. If the other player has one or more cards of that face value in his hand, he gives them 
to the first player, and the first player makes another request. Eventually, the first player asks 
for a card which is not in the second player’s hand: he replies ‘GO FISH!’ The first player then 
draws a card from the ‘pool’ of undealt cards. If this is the card he had last requested, he 
draws again. When a book is made, either through drawing or requesting, the cards are laid 
down and no further action takes place with that face value. 

To play the computer, simply make guesses by typing a. 2, 3, 4, 5, 6, 7, 8, 9, 10. j, q, or k 
when asked. Hitting return gives you information about the size of my hand and the pool, and 
tells you about my books. Saying ‘p’ as a first guess puts you into ‘pro’ level: The default is 
pretty dumb. 
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NAME 

hangman — Computer version of the game hangman 
SYNOPSIS 

/usr/gimes/hangman 

DESCRIPTION 

In hangman, the computer picks a word from the on-line word list and you must try to guess it. 
The computer keeps track of which letters have been guessed and how many wrong guesses 
you have made on the screen in a graphic fashion. 

FILES 

/usr/dict/words On-line word list 
AUTHOR 

Modified for terminal graphics from the original source from BTL by Michael Toy. 

BUGS 
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NAME 

worm “ Play the growing worm game 

SYNOPSIS 

worm l see] 

DESCRIPTION , , . ( i a ftf1 *!>• erfMn nid your head is the @ » 

YoiTmcrve'witMhe hjW ZyTllsZ ithe game snake ^ y °“fifTo^hadl.ressed 

STsSXSS - - 

how long you can make the worm grow. 

The game ends .hen the worm runs into either the sides of the screen, of iodf_Th. current 
S much the worn, has grown) is kept in the upper left comer of the screen. 

The optional argument, if present, is the initial length of the worm. 


BUGS 


If the initial length of dm .orm is set to less than one or more than 75, various strange things 
happen. 
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NAME 

worms 


— animate worms on a display terminal 


SYNOPSIS 

worms 


•field 1 (-length # 1 l -number # ] l -trail ] 


D “ C “w” Horn CddrnMh) showed me a TOPS-20 program on Use DEC-MM nmchihe edled 
\oRM, and suggested that I write a similar program that would run under Una. I dtd. 


apologies. 

-field makes a 'field" for the worm(s) to eat; -trail causes 
You can figure out the rest by yourself. 


each worm to leave a trail behind 


it. 


FILES 

/etc/termcap 

author 

Eric P. Scott 


SEE ALSO 

Snails, by Karl Heuer 

DIAGNOSTICS 

Invalid length 

Vaiue not in range 2 < — length < — 1024 

Invalid number of worms 

Vaiue not in range 1 < — number < * 40 

TERM: parameter not set 

The TERM environment variable is not defined, do 




TERM-terminal type 
export TERM 


Unknown terminal type 

Your terminal type 
defined in /etc/termcap. 


is determined from the TERM environment variable) is not 


Terminal not capable of cursor motion 

Your terminal is too stupid to run this program. 


Out of memory 

This should never happen on a VAX. 


BUGS 


The lower-right-hand character position will not be updated properly on a terminal that wraps at 
the right margin. 

Terminal initialization is not performed. 

There should be an option to have the worms eat Pink Floyd lyrics. 
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NAME 

fsck — file system consistency check and interactive repair 
SYNOPSIS 

/etc/fsck -p [ filesystem ... ] 

/etc/fsck l —y ] [ — o ] ( -sX ] [ —SX ] ( — t filename 1 ( filesystem ] ... 

DESCRIPTION 

The first form of fick preens a standard set of filesystems or the specified file systems. It is 
normally used in the script /etc/rc during automatic reboot. In this case fsck reads the table 
/etc/fstab to determine which file systems to check. It uses the information there to inspect 
groups of disks in parallel taking maximum advantage of i/o overlap to check the file systems as 
quickly as possible. Normally, the root file system will be checked on pass 1, other “root” 
(“a” partition) file systems on pass 2, other small file systems on separate passes (e.g. the “d" 
file systems on pass 3 and the “e” file systems on pass 4), and finally the large user file systems 
on the last pass, e.g. pass 5. A pass number of 0 in fstab causes a disk to not be checked: simi¬ 
larly partitions which are not shown as to be mounted "rw” or “ro” are not checked. 

The system takes care that only a restricted class of innocuous inconsistencies can happen 
unless hardware or software failures intervene. These are limited to the following: 

Unreferenced inodes 

Link counts in inodes too large 

Missing blocks in the free list 

Blocks in the free list also in files 

Counts in the super-block wrong 

These are the only inconsistencies which fick with the - p option will correct; if it encounters 
other inconsistencies, it exits with an abnormal return status and an automatic reboot will then 
fail. For each corrected inconsistency one or more lines will be printed identifying the file sys¬ 
tem on which the correction will take place, and the nature of the correction. After success¬ 
fully correcting a file system, fick will print the number of files on that file system and the 
number of used and free blocks. 

Without the —p option, fick audits and interactively repairs inconsistent conditions for file sys¬ 
tems. If the file system is inconsistent the operator is prompted for concurrence before each 
correction is attempted. It should be noted that a number of the corrective actions which are 
not fixable under the —p option will result in some loss of data. The amount and severity of 
data lost may be determined from the diagnostic output. The default action for each con¬ 
sistency correction is to wait for the operator to respond yes or no. If the operator does not 
have write permission ./Sc* will default to a -n action. 

Fsck has more consistency checks than its predecessors check, dcheck. /check, and icheck com¬ 
bined. 

The following Hags are interpreted by fick. 

—y Assume a yes response to all questions asked by fick: this should be used with great cau¬ 
tion as this is a free license to continue after essentially unlimited trouble has been 
encountered. 

—n Assume a no response to ail questions asked by fide; do not open the file system for 
writing. 

Ignore the actual free list and (unconditionally) reconstruct a new one by rewriting the 
super-block of the file system. The file system should be unmounted while this is done; 
if this is not possible, care should be taken that the system is quiescent and that it is 
rebooted immediately afterwards. This precaution is necessary so that the old. bad. in- 
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core copy of the superblock will not continue to be used, or written on the file system. 

The - sX option allows for creating an optimal free-list organization. The following 
forms of X are supported for the following devices: 

—s3 (RP03) 

-s4 (RP04, RP05, RP06) 

—sBlocks-per-cylinder:Blocks-to-skip (for anything else) 

If X is not given, the values used when the filesystem was created are used. If these 
values were not specified, then the value 400:9 is used 

•SX Conditionally reconstruct the free list This option is like —sX above except that the free 
list is rebuilt only if there were no discrepancies discovered in the file system. Using - S 
will force a no response to all questions asked by fick. This option is useful for forcing 
free list reorganization on uncontaminated file systems. 

—t If fick cannot obtain enough memory to keep its tables, it uses a scratch file. If the -t 
option is specified, the file named in the next argument is used as the scratch file, if 
needed. Without the — t flag, fick will prompt the operator for the name of the scratch 
file. The file chosen should not be on the filesystem being checked, and if it is not a spe¬ 
cial file or did not already exist, it is removed when fick completes. 

If no filesystems are given to fick then a default list of file systems is read from the file 
/etc/fstab. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one inode or the free list. 

2. Blocks claimed by an inode or the free list outside the range of the file system. 

3. Incorrect link counts. 

4. Size checks: 

Directory size not 16-byte aligned. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 

Inode number out of range. 

8. Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in the file system. 

9. Bad free block list format 

10. Total free block and/or free inode count incorrect 

Orphaned files and directories (allocated but unreferenced) are, with the operator's con¬ 
currence, reconnected by placing them in the lost+found directory. The name assigned is the 
inode number. The only restriction is that the directory lost + found must preexist in the root of 
the filesystem being checked and must have empty slots in which entries can be made. This is 
accomplished by making lost + found, copying a number of files to the directory, and then 
removing them (before fickis executed). 

Checking the raw device is almost always faster. 

FIL£S 

/etc/fstab contains default list of file systems to check. 

DIAGNOSTICS 

The diagnostics produced by fick are intended to be self-explanatory. 
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SEE ALSO 

fstab(5), fs(5), crash(8), reboot(8) 

BUGS 

Inode numbers for . and .. in each directory should be checked for validity, 
-g and -b options from cAeck should be available in Jzck. 

There should be some way to start a fsck -p at pass n 
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